Copyright: Peer Tracer Help V 1.24 ©1999 Comtrol Corporation
Citation: Peer Tracer Help V 1.24 ©1999 Comtrol Corporation. All Rights Reserved.


Contents
Peer Tracer Help Contents

Overview

Using Peer Tracer

Trace Log File Functions

Example: Tracing Modem Initialization

Obtaining Technical Support

Copyrights and Trademarks

 Shortcut to Peer Tracer program


Overview

The Peer Tracer program (peer.exe) is specifically designed to help you view the internal operations of the Comtrol software, for the purpose of troubleshooting communications. Peer Tracer enables you to see:

•	Receive and transmit data

•	Internal software event traces

•	Advanced configuration and status information

Like Test Terminal (wcom32.exe), Peer Tracer acts as a simple terminal session, and is used to send and receive text information to and from the Comtrol software. To use Peer Tracer, you type in commands, and status and information are sent back.

Unlike Test Terminal, Peer Tracer also enables you to keep a continuous log of the commands sent and the responses received, in a file named peer.log.


Using Peer Tracer

To start Peer Tracer, use Windows Explorer to open the Rocket software directory (under \WINNT\system32) and double-click on Peer.exe, or click this button:

Once the Peer Tracer window is displayed, type in commands at the : prompt. (It may be necessary to press Enter to make the : prompt appear.) For example, to examine COM5, type:

PORT COM5 <Enter>

To gather some information about the port, type:

STAT <Enter>

This should return details about the port.

To turn on monitoring of any software events (calls into the Comtrol software), type:

MON EV <Enter>

Other Commands

You can use Peer Tracer to send strings out the port to attached peripherals. For example, to send ATH0, type:

SEND ATH0 <Enter>

A return and linefeed are always appended to each string sent out.

Transmit data from the application can be monitored by typing:

MON TX <Enter>

Receive data from the application can be monitored by typing:

MON RX <Enter>

All monitoring (TX, RX, EV) is turned off by typing:

M <Enter>

If you forget these commands, a summary of the commands can be obtained by typing:

? <Enter>

If you want to change the port being examined, type a new PORT command, for example:

PORT COM6 <Enter>

Keep in mind that all commands are processed in the Comtrol software, and that Peer simply acts as a conduit for this information.


Trace Log File Functions

All Peer Tracer logging functions are found under the File menu. Options are:

Log to Disk	Toggle start/stop logging all events in file peer.log.

View Disk Log	View peer.log in Notepad.

Clear Disk Log	Purge all entries in peer.log.

Clear Screen	Blank screen. This does not affect peer.log.

Exit	Exit Peer Tracer. This does not affect peer.log.


Example: Tracing Modem Initialization

Follow these steps:

1.	Start Peer Tracer and select the port you wish to examine. For example, to examine an external modem on COM5, enter PORT COM5 <Enter>.

2.	From the File menu, select Log to Disk to begin logging driver events.

3.	Enter this command to turn on receive data monitoring: MON RX <Enter>.

4.	Force RAS to reinitialize the modem, for example, by cycling the power on the modem.

5.	Watch the screen for the modem commands.

6.	When you are done, enter this command to stop monitoring: M <Enter>.

You can also use the View Disk Log option to review the log file in Notepad.


Obtaining Technical Support

Comtrol manuals and other documents are available in electronic form on the Comtrol web site. Software updates can be downloaded at no charge from the Comtrol ftp site. Always check the web and ftp sites to make sure that you have the current software and documentation.

Comtrol has a staff of support technicians available to help you. U.S. telephone support is available during standard Central time zone business hours, Monday through Friday (holidays excluded).

Corporate Corporate Headquarters

Internet URL: http://www.comtrol.com

email: support@comtrol.com

FTP site: ftp://ftp.comtrol.com

FAX: (651) 631-8117

Phone: (651) 631-7654

Comtrol Europe

Internet URL: http://www.comtrol.co.uk

email: support@comtrol.co.uk

FAX: +44 (0) 1 869-323-211

Phone: +44 (0) 1 869-323-220


Copyrights and Trademarks

All software and contents 1995 - 1999 Comtrol Corporation.

All Rights Reserved.

Comtrol Corporation makes no representations or warranties with regard to the contents of this documentation or to the suitability of the Comtrol products for any particular purpose. Specifications subject to change without notice. Some software or features may not be available at the time of publication. Contact your reseller for current product information.

Trademarks

Comtrol is a trademark of Comtrol Corporation.

Windows, Windows NT, and Windows 2000 are either registered trademarks or trademarks of Microsoft Corporation in the United States and/or other countries.

Other product names mentioned herein may be trademarks and/or registered trademarks of their respective companies.